home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / bllist2.zip / BLLIST2.DOC < prev    next >
Text File  |  1992-11-27  |  11KB  |  280 lines
  1.  
  2.  
  3.  
  4.               BEST LITTLE BBS LISTER DOCUMENTATION!
  5.  
  6.                    verison # 2
  7.  
  8.            COPYRIGHT (c) 1992  CORVETTE BBS SOFTWARE
  9.  
  10.                    ALL RIGHTS RESERVED!
  11.  
  12.                 QUICKBASIC CODE BY
  13.  
  14.                  GEORGE  BATALIAS
  15.  
  16.                 SYSOP CORVETTE BBS
  17.  
  18.                 Las Vegas,  Nevada
  19.  
  20.                   1-702-431-2284
  21.  
  22.                A REGISTERED WILDCAT! SYSTEM
  23.  
  24.  
  25.                 dated: 11-25-92
  26.  
  27.  
  28.      First, let's get the legal stuff out of the way! This program is not
  29.  guaranteed to do anything but take up space on your hard drive! The
  30.  author(me) will not be held responsible for any damage to anything whatsoever.
  31.  If you use this program, you use it at your own risk!
  32.  
  33.      Second. I am NOT asking for any money for this program. All i ask is that
  34.  if you use this program please call my bbs and leave me a message as to what
  35.  you think of it. There is NO FEE for using THE BEST LITTLE BBS LISTER.... If
  36.  you upload this program to another bbs, then, you must upload the entire ZIP
  37.  archive with all the files intact and unmodified in any way. You can also
  38.  contact me on the Mustang Wildcat! Sysop BBS in Bakersfield or at my bbs
  39.  in Las Vegas.
  40.  
  41.      You are encouraged to pass BLLIST2.ZIP to other bbs's only in it's
  42.  original form!..... Please and Thankyou!
  43.  
  44.  
  45.          ----------- THIS PROGRAM IS FREE! ----------
  46.  
  47.     THIS VERSION NOW USES DOOR.SYS FOR THE BBS DROPFILE (WC3.X)
  48.  
  49.       *********************************************************
  50.  
  51.   This program is NOT public domain and remains the sole ownership of the
  52.  author(me again)!
  53.     I hope you enjoy this program and find it useful enough to use it! This is
  54.  an update of BLLIST. It's written in Quick Basic 4.5 using Catpatch routines.
  55.  This door DOES require BRUN45.EXE to work! The code takes up a lot less space.
  56.  Make sure BRUN45.EXE is in your DOS path directory or in the directory
  57.  where you are putting BLLIST2. A patched copy is included with this
  58.  zipfile.
  59.  
  60.  
  61.   **************************************************************************
  62.  
  63.                >>>>>  BLLIST2.EXE  INFO  <<<<<
  64.  
  65.    BLLIST2 writes both color and black/white bulletins! The path and
  66.  name for the bulletins is read from the config file! This program should
  67.  run on com ports 1-4, but i have only tested on comm 1 and 2.
  68.  
  69.    To run on a com port other than 1 or 2 you must make a file with any
  70.  text editor as follows. Name it COM#.DEF where # is the number of the comm
  71.  port.
  72.        COMM3.DEF
  73.          modem control register location (in HEX)
  74.          modem status register memory location (in HEX)
  75.  
  76.  read your BBS manual for optional com port registers and memory. If a com
  77.  port is specified other than comm 1 or 2 then you must make this file. It
  78.  will be looked for if other than comm 1 or 2. If not found then the door
  79.  will exit with an error. Sysops using comm1 or comm2 do not need this.
  80.  
  81.  
  82.    If a user has his/her color or graphic's set to off (no color...no ansi)
  83.  then the door will automatically show the user everything in (no ansi)
  84.  black and white ( or whatever he has set). The sysop screen will be in color
  85.  if the sysop has color (ansi). If you want to remove a listing you will have
  86.  to delete the bbs.dat file. This will cause BBLLIST2 to open a neww bbs.dat
  87.  file when a NEW listing is posted, because there won't be any entries. I do
  88.  not know if this program will run under DESKVIEW or on a MULTINODE system.
  89.  If a user drops carrier in the door, then the program will close all files
  90.  and return control back over to the bbs. If there is no input in 3 minutes
  91.  then control is handed back over to the bbs. If you would like, you can run
  92.  the door in local mode. Just type BLLIST2 LOCAL at the dos prompt. If run
  93.  in local mode then the color and black/ white bulletins will be made in
  94.  the directory that the door is in. BLLIST2 when run in local mode does not
  95.  read the BLLIST2.CFG file. The color file will be bull1.scr and the b/w
  96.  file will be bull1.bbs.
  97.  
  98.  
  99.    The BLLIST2 will write to a color bulletin and a black/white
  100.  bulletin. The full path and file name must be included in the config file.
  101.  
  102.  Example c:\wc30\bull\bull30.scr will write a color bulletin bull30.scr ( or
  103.  what ever filename and extension you give it ) in the bull directory off
  104.  c:\wc30 . Upper case or lower case does not matter. The color bulletin will
  105.  be called bull30.scr. Choose the path, filename and extention to match
  106.  your system. You must enter the door from remote to update the bulletins.
  107.  
  108.  Doing a local logon from the DOS prompt will only create a scr and bbs
  109.  bulletin in the current directory. Doing a logon from your bbs will update
  110.  the bulletins to the proper area.
  111.  
  112.    Same goes for the black/white bulletin except this is named bullXX.bbs or
  113.  infact you can name the color and black/white bulletins anything you wanted
  114.  as long as the proper path name and file is specified in the correct line
  115.  of BLLIST2.CFG. Again, choose the path, filename and extension to match
  116.  your system.
  117.  
  118.    All color bulletins are ANSI coded for color.
  119.  
  120.  I presently use this on my board for a bbs lister. Be sure to look for more
  121.  programs from me. The latest version can be downloaded from my board.
  122.  
  123.  
  124.  
  125.    There should be 5 files included with BLLIST2.ZIP :
  126.  
  127.             BLLIST2.EXE    >>>>> main program
  128.  
  129.             BLLIST2.DOC    >>>>> program documentation
  130.  
  131.             BLLIST2.CFG    >>>>> sample config. file
  132.  
  133.             DOORxx.BAT    >>>>> sample batch file
  134.  
  135.             BRUN45.EXE    >>>>> patched copy of BRUN45.EXE
  136.  
  137.  
  138.     The BLLIST2 is designed to run under Wildcat! 3.XX which uses DOOR.SYS
  139.  If you are running under a different version of Wildcat! such as version 2.x
  140.  or a different BBS program you must convert your drop file or whatever
  141.  your BBS uses to door.sys. There are many utilities out there for doing
  142.  this. Besides thats another story. The BLLIST2 is set up just like any
  143.  other door. It must reside in its own directory and have access to
  144.  door.sys. You should edit the bllist2.cfg to look like this ( without
  145.  the comments of course ):
  146.  
  147.                   |-------------comments------------------|
  148.  
  149.   CORVETTE BBS                <--NAME OF YOUR BBS
  150.   GEORGE                <--SYSOP'S FIRST NAME
  151.   BATALIAS                <--SYSOP'S LAST NAME
  152.   C:\WC30\WCWORK\NODE1\DOOR.SYS     <--PATH TO DOOR.SYS
  153.   NO                    <--LOCK THE BAUD RATE
  154.   C:\WC30\BULLETINS\BULL#1.SCR      <--PATH AND FILE NAME FOR COLOR BULLETIN
  155.   C:\WC30\BULLETINS\BULL#1.BBS      <--PATH AND FILE NAME FOR B/W BULLETIN
  156.  
  157.  
  158.  
  159.  
  160.  
  161.   BLLIST2 should run at 19,200 baud, although it hasn't been checked at that
  162.  speed yet. Plus, you can lock baud rate by specifying in the config file
  163.  line 5 by putting   NO   for NOlock baud rate OR specify the baud rate to lock the
  164.  com port at.  ie. 19,200
  165.  
  166.  
  167.  
  168.   Here is a sample batch file to call the door if you use Wildcat! v 3.x :
  169.  
  170.  
  171.       doorXX.bat        <--XX is number
  172.  
  173.     echo off            <--doesn't echo the bat file to local screen
  174.     cls                <--clears screen
  175.     cd\bllist2           <--change to dir. where bllist2 is
  176.     bllist2  bllist2.cfg  <--calls bllist2.exe with bllist2.cfg
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.    A good way to check for proper execution is to leave the echo on. This
  185.  way you can watch the bat file and see if there's any problem with it.
  186.  See your Wildcat! documentation for proper location of doorXX.bat files
  187.  and conversion program locations. Also door locations.
  188.  
  189.     Remember, BLLIST2 now uses door.sys and must be able to find it. If you
  190.  are using anything other than WILDCAT! 3.X  then you must convert your
  191.  dropfile or whatever over to door.sys or the door will not run!
  192.  
  193.    The BLLIST2 is a program that writes to a random access file called
  194.  BBS.DAT This file will be created only if a user adds a bbslisting. It
  195.  will be created when the door is first run and does not need to be there
  196.  for the door to be run. Once the door is initialized and the first entry
  197.  is added, the bbs.dat will be created. To REMOVE an entry, the sysop must
  198.  delete ALL of the bbs.dat. It is (but no mandatory)
  199.  recommended that the sysop enter the door locally or thru his/her board
  200.  and add the first listing. ( though this is not needed for the door to run)
  201.  Of course the first BBS Listing would be the Sysop's Board info.
  202.  
  203.   A sample of the screen will look like this:
  204.  
  205.  
  206.                 THE BEST LITTLE BBS LISTER
  207.                      v 2 beta
  208. -------------------------------------------------------------------------------
  209.        BBS NAME            CITY       ST      NUMBER     DATE POSTED
  210. -------------------------------------------------------------------------------
  211. |  CORVETTE BBS             | LAS VEGAS | NV | 702-431-2284  |  11-01-1992   |
  212. |  RESERVATION ONLY!  #1     | LAS VEGAS | NV | 702-898-2630  |  11-23-1992   |
  213. |  RESERVATION ONLY   #2     | LAS VEGAS | NV | 702-898-8630  |  11-23-1992   |
  214. |  THE LAS VEGAS CENTER      | LAS VEGAS | NV | 702-597-1931  |  11-23-1992   |
  215.  
  216.  
  217.    As you can see its a very little bbs lister as far as information goes. BUT,
  218.  its basic in its concept, and has the minimum needed information. That's why
  219.  its called THE BEST LITTLE BBS LISTER.  =:+)
  220.  
  221.    As far as i can tell, you can have an unlimited number of listings.
  222.  When adding a bbs listing, after the user inputs the listing he/she will be
  223.  asked if the information that they have listed is correct (after being shown
  224.  what they has listed). If it needs correction or change, BLLIST2 gives the
  225.  option of not adding the listing as was listed and returning back to the main
  226.  menu where the user can relist in bbs info if so desired.
  227.  
  228. SYSOPS WHO USE THE OLDER VERSION
  229.  
  230.   This version is compatable with older version databases. All you have to do is
  231.  copy over the exe file and redo your cfg file to specify where door.sys is
  232.  instead of callinfo.bbs.(you don't need a dropfile conversion program)
  233.  Maybe modify your door#.bat file.
  234.  
  235. HINTS FOR WC3
  236.  
  237.    In your main menu you can add a BBS lister Door (dos hook). Just redo
  238.  your main menu and have a letter to (L) List a bbs. Then in the wc30 directory
  239.  you will need a main1.bat file which is the same as doorXX.bat that calls
  240.  the BLLIST2 door. In Makewild for your DOS hook #1 in the main menu
  241.  configuration, put L (List a BBS)for the letter. Then set the security level
  242.  so  users that can use this dos hook.
  243.     When they hit L key at the main menu they will "hook" to the door thru the
  244.  main1.bat which is the same as doorXX.bat for the BLLIST2 in the door
  245.  menu.
  246.   Simple NO!!??
  247.  
  248.               **********************************
  249.  
  250.  
  251.  
  252.  
  253.  
  254.     Call my bbs (702-431-2284) for the latest release or to
  255.  let me know how the program works on your system. All systems are different
  256.  and this program may or may not be what you need. But, remember, its free
  257.  and you get what you pay for...... =:)>
  258.  
  259.  
  260.  
  261.  
  262.  THANX'S
  263.  
  264.  
  265.  
  266.                   George Batalias
  267.                    sysop
  268.                    CORVETTE  BBS
  269.                 2206 Cascade Street
  270.                  Las Vegas, Nevada
  271.                   1-702-431-2284
  272.                    call anytime!
  273.                    N-8-1
  274.  
  275.             a registered Wildcat! 3.55 system
  276.  
  277.  
  278.  
  279.  ----------------------------------<eof>--------------------------------------
  280.